大麦家礼品代发API

# 获取面单(非智能)

接口地址： http://www.damaijia168.com/vv/external/gcwb

请求方式： POST

传参方式： JSON

返回格式： JSON

# 请求头参数

参数 类型 必选 值 示例
Authorization string 是 授权 access_token 1798c6aadec33d1bc2f5b707f1049aefexxxx

# 请求参数

参数 类型 必选 描述
sellerNick string 是 掌柜号
shopCode string 是 菜鸟 token
senderAddress string 是 发货详细地址
orderNo string 是 订单号
goodsInfoList array 是 礼品信息
goodsCount string 是 礼品数量
goodsId string 是 礼品 id
goodsName string 是 礼品名称
goodsWeight string 是 礼品重量
receiverName string 是 收件人姓名
senderDistrict string 是 发货区县
receiverProvince string 是 收件省
senderProvince string 是 发货省
receiverCity string 是 收件市
senderCity string 是 发货市
templateUrl string 是 模板地址
receiverAddress string 是 收件详细地址
senderPhone string 是 发货人号码
senderName string 是 发货人姓名
receiverPhone string 是 收件人号码
receiverDistrict string 是 收件区
wpCode string 是 YTO 快递编号

# 请求示例

{
  "orderNo": "10000000003",
  "receiverProvince": "**省",
  "receiverCity": "**市",
  "receiverDistrict": "AAA区",
  "receiverAddress": "BBBBB公司",
  "receiverName": "X先生",
  "receiverPhone": "15088256666",
  "senderProvince": "湖北省",
  "senderCity": "**市",
  "senderDistrict": "NN市",
  "senderAddress": "MMMMM区",
  "senderName": "礼栈",
  "senderPhone": "18****666",
  "templateUrl": "http://cloud***mplate/sta***59/40",
  "shopCode": "SaXR0****lpraw==",
  "wpCode": "YUNDA",
  "goodsInfoList": [
    {
      "goodsCount": 1,
      "goodsId": 14,
      "goodsWeight": "0.02",
      "goodsName": "2020年新*********送礼高端"
    }
  ]
}

# 请求代码示例

cURL请求代码示例

curl --location --request POST 'http://www.damaijia168.com/vv/external/taoForSurfaceSingleFzn' --header 'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx' --header 'Content-Type: application/json' --data-raw '{
  "orderNo": "10000000003",
  "receiverProvince": "**省",
  "receiverCity": "**市",
  "receiverDistrict": "AAA区",
  "receiverAddress": "BBBBB公司",
  "receiverName": "X先生",
  "receiverPhone": "15088256666",
  "senderProvince": "湖北省",
  "senderCity": "**市",
  "senderDistrict": "NN市",
  "senderAddress": "MMMMM区",
  "senderName": "礼栈",
  "senderPhone": "18****666",
  "templateUrl": "http://cloud***mplate/sta***59/40",
  "shopCode": "SaXR0****lpraw==",
  "wpCode": "YUNDA",
  "goodsInfoList": [
    {
      "goodsCount": 1,
      "goodsId": 14,
      "goodsWeight": "0.02",
      "goodsName": "2020年新*********送礼高端"
    }
  ]
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://www.damaijia168.com/vv/external/taoForSurfaceSingleFzn',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "orderNo": "10000000003",
  "receiverProvince": "**省",
  "receiverCity": "**市",
  "receiverDistrict": "AAA区",
  "receiverAddress": "BBBBB公司",
  "receiverName": "X先生",
  "receiverPhone": "15088256666",
  "senderProvince": "湖北省",
  "senderCity": "**市",
  "senderDistrict": "NN市",
  "senderAddress": "MMMMM区",
  "senderName": "礼栈",
  "senderPhone": "18****666",
  "templateUrl": "http://cloud***mplate/sta***59/40",
  "shopCode": "SaXR0****lpraw==",
  "wpCode": "YUNDA",
  "goodsInfoList": [
    {
      "goodsCount": 1,
      "goodsId": 14,
      "goodsWeight": "0.02",
      "goodsName": "2020年新*********送礼高端"
    }
  ]
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n  \"orderNo\": \"10000000003\",\r\n  \"receiverProvince\": \"**省\",\r\n  \"receiverCity\": \"**市\",\r\n  \"receiverDistrict\": \"AAA区\",\r\n  \"receiverAddress\": \"BBBBB公司\",\r\n  \"receiverName\": \"X先生\",\r\n  \"receiverPhone\": \"15088256666\",\r\n  \"senderProvince\": \"湖北省\",\r\n  \"senderCity\": \"**市\",\r\n  \"senderDistrict\": \"NN市\",\r\n  \"senderAddress\": \"MMMMM区\",\r\n  \"senderName\": \"礼栈\",\r\n  \"senderPhone\": \"18****666\",\r\n  \"templateUrl\": \"http://cloud***mplate/sta***59/40\",\r\n  \"shopCode\": \"SaXR0****lpraw==\",\r\n  \"wpCode\": \"YUNDA\",\r\n  \"goodsInfoList\": [\r\n    {\r\n      \"goodsCount\": 1,\r\n      \"goodsId\": 14,\r\n      \"goodsWeight\": \"0.02\",\r\n      \"goodsName\": \"2020年新*********送礼高端\"\r\n    }\r\n  ]\r\n}");
Request request = new Request.Builder()
  .url("http://www.damaijia168.com/vv/external/taoForSurfaceSingleFzn")
  .method("POST", body)
  .addHeader("Authorization", "1798c6aadec33d1bc2f5b707f1049aefexxxx")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

Python请求代码示例

import requests
import json

url = "http://www.damaijia168.com/vv/external/taoForSurfaceSingleFzn"

payload = json.dumps({
  "orderNo": "10000000003",
  "receiverProvince": "**省",
  "receiverCity": "**市",
  "receiverDistrict": "AAA区",
  "receiverAddress": "BBBBB公司",
  "receiverName": "X先生",
  "receiverPhone": "15088256666",
  "senderProvince": "湖北省",
  "senderCity": "**市",
  "senderDistrict": "NN市",
  "senderAddress": "MMMMM区",
  "senderName": "礼栈",
  "senderPhone": "18****666",
  "templateUrl": "http://cloud***mplate/sta***59/40",
  "shopCode": "SaXR0****lpraw==",
  "wpCode": "YUNDA",
  "goodsInfoList": [
    {
      "goodsCount": 1,
      "goodsId": 14,
      "goodsWeight": "0.02",
      "goodsName": "2020年新*********送礼高端"
    }
  ]
})
headers = {
  'Authorization': '1798c6aadec33d1bc2f5b707f1049aefexxxx',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

# 响应参数

参数 类型 描述
data object 返回数据
----orderNo string 订单号
----printData string 打印数据
----waybillNo string 面单号
----amount int 消耗点券
status int 状态码，0为成功

# 返回数据

{
  "data":{
        "orderNo": "100000000053",
        "printData": "打印成功",
        "waybillNo":"4********0"
    },
  "status": 0
}

# 错误码

状态码(status)） 错误说明
1003 用户不存在
132 请求格式必须为JSON
422 参数列表不合法，在err中会给出提示
200 认证失败
202 商品id不合法
203 仓库id不合法
228 订单来源不合法
217 创建订单失败
212 包裹id不合法
209 账户余额不足

← 8_子订单发货 →